Skip to content

docs(S4PL-00416EU): note about unexpected switch-off / power_on_behavior#5072

Merged
Koenkk merged 2 commits intoKoenkk:masterfrom
coyotte508:feat/shelly-power-strip-power-on-behavior-note
May 5, 2026
Merged

docs(S4PL-00416EU): note about unexpected switch-off / power_on_behavior#5072
Koenkk merged 2 commits intoKoenkk:masterfrom
coyotte508:feat/shelly-power-strip-power-on-behavior-note

Conversation

@coyotte508
Copy link
Copy Markdown
Contributor

@coyotte508 coyotte508 commented May 1, 2026

Add note about unexpected switch-off on Shelly Power Strip 4 Gen4

Disclosure: the wording and this PR description were drafted by an AI coding assistant under my direction; the underlying behavior was verified live on a Shelly Power Strip 4 Gen4 before submission.

Adds a Notes section entry to the S4PL-00416EU device page explaining:

  • The "unexpected switch-off" behavior reported by many users on the Shelly community (thread #11999) — by default sockets turn off after any power loss / reboot.
  • How to fix it via the new per-socket power_on_behavior expose (set to previous).
  • That the setting is saved on the device and persists across reboots.

Companion PR

This depends on the converter PR adding the expose: Koenkk/zigbee-herdsman-converters#12086

The auto-generated sections of the device page (Exposes table, "Power on behavior (enum, N endpoint)" sections, etc.) will be regenerated by docgen after the converter PR is merged and a new release is published — this PR only edits the hand-editable ## Notes section.

…ehavior

Adds a note to the device page covering the "unexpected switch-off" issue
reported on the Shelly community forum and explains how to fix it via the
new per-socket power_on_behavior expose (see
Koenkk/zigbee-herdsman-converters#PR_NUMBER).

The auto-generated sections of the page will be regenerated by docgen
after the converter PR is merged and a new release tagged.
@coyotte508 coyotte508 force-pushed the feat/shelly-power-strip-power-on-behavior-note branch from 63ac311 to 65ee8ac Compare May 1, 2026 19:07
@Koenkk
Copy link
Copy Markdown
Owner

Koenkk commented May 4, 2026

thanks, let me know once this can be merged.

@coyotte508 coyotte508 marked this pull request as ready for review May 4, 2026 20:35
Copilot AI review requested due to automatic review settings May 4, 2026 20:35
@coyotte508
Copy link
Copy Markdown
Contributor Author

Thanks, was just waiting for the other PR to be merged! Ready now

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds user-facing documentation for the Shelly S4PL-00416EU device page to explain and mitigate reports of sockets switching off unexpectedly after power events.

Changes:

  • Adds a new “Unexpected switch-off after reboot or power loss” note to the device’s hand-editable Notes section.
  • Documents the expected fix via the power_on_behavior setting (restore previous state).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/devices/S4PL-00416EU.md Outdated
Comment thread docs/devices/S4PL-00416EU.md Outdated
Reportedly, the device is frequently publishing status updates to the network [GitHub issue](https://github.com/Koenkk/zigbee2mqtt/issues/30544), [Shelly community](https://community.shelly.cloud/topic/11528-zigbee-network-instability-flooding-with-two%C2%A0shelly-power-strip-4-gen4%C2%A0zigbee2mqtt-cc2652p7/). Depending on your network and the number of Shelly power strips, this may cause instabilities. In that case, try modifying the reporting settings or enable debouncing as described [here](https://github.com/maxim-mityutko/hass/blob/38341583e521ed77459e5974e02b1e6d44ff1f5a/docs/tests/shelly-power-strip-4-gen4.md).

### Unexpected switch-off after reboot or power loss
By default, the sockets turn **off** after any reboot or power loss, which can look like the strip "randomly" switching off (see this [Shelly community thread](https://community.shelly.cloud/topic/11999-unexpected-switch-off/)). To have sockets restore their previous state instead, set `power_on_behavior` to `previous` on each socket. The setting is saved on the device and persists across reboots.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will be automatically fixed after doc gen?

Comment thread docs/devices/S4PL-00416EU.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@Koenkk
Copy link
Copy Markdown
Owner

Koenkk commented May 5, 2026

Thanks!

@Koenkk Koenkk merged commit 56c7d08 into Koenkk:master May 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants